home *** CD-ROM | disk | FTP | other *** search
/ mac CD 73 / Image.iso / macware / Setting Sun 1.4 ƒ / Setting Sun Read Me < prev   
Text File  |  2000-08-06  |  15KB  |  315 lines

  1. Setting Sun Read Me
  2. Copyright © 1999-2000 Dair Grant <dair@webthing.net>
  3. <http://www.webthing.net/>
  4.  
  5. What is Setting Sun?
  6.  
  7. Setting Sun is a Mac OS screen saver, which uses plug-ins to draw interesting images when your computer is idle. Although screen savers are not strictly necessary (since most modern monitors can turn themselves off when idle), they still provide a nice distraction from a blank screen - and allow you to lock your display with a password.
  8.  
  9. Setting Sun requires QuickTime and a PowerPC based Mac, running Mac OS 8.1 or later.
  10.  
  11. Setting Sun runs as a normal Mac OS application - it does not require any Control Panels, Extensions, or Background Applications.
  12.  
  13.  
  14. 3D Faders
  15.  
  16. One of the main differences between Setting Sun and other Macintosh screen savers is that Setting Sun includes a wide range of 3D modules.
  17.  
  18. To run these faders, Setting Sun requires both QuickDraw 3D and OpenGL to be installed. A fast Mac, ideally with 3D hardware acceleration, is also recommended.
  19.  
  20. QuickDraw 3D and OpenGL can both be installed using Apple’s OpenGL installer, which can be downloaded from <http://www.apple.com/opengl/>. If you are using Mac OS 9.0, both QuickDraw 3D and OpenGL are already installed.
  21.  
  22. Older machines may require 3D acceleration hardware to obtain reasonable results - iMacs, iBooks, Blue/White G3s, or G4s all have 3D acceleration hardware built-in and are perfect for running Setting Sun.
  23.  
  24.  
  25. Registering Setting Sun
  26.  
  27. Setting Sun costs $20. You may evaluate it free of charge for 30 days, after which you should register to purchase your copy. Registering will remove the reminder message which will start to appear after the 30 day evaluation period is over.
  28.  
  29. Payments are processed by Kagi Shareware, who provide an on-line ordering service at <http://order.kagi.com/?DG>.
  30.  
  31. Payments can also be submitted by fax, email, or post by using the supplied Register application. Full details of these payment methods are contained in the “How To Register” document.
  32.  
  33.  
  34. Using Setting Sun
  35.  
  36. To use Setting Sun, double-click the application. The first time you launch it, the Preferences window will be displayed - to open this window in the future, select “Preferences” from the Edit menu.
  37.  
  38. The Preferences window forms the main user interface for Setting Sun, and contains several panels. Taking each panel in turn:
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. The General panel is divided into three sections: Application, Fading, and Switching.
  70.  
  71. The Application section allows you to start Setting Sun automatically at startup (and bring the Finder to the front again after Setting Sun has been launched), and to disable the Command-Q shortcut for quitting Setting Sun.
  72.  
  73. When the startup checkbox is selected, an alias to Setting Sun will be created for you in the Startup Items folder in your System folder. Deselecting this checkbox will remove this alias file.
  74.  
  75.  
  76. The Fading section provides some generic control over the fader modules. The time before a module is activated can be set to the nearest minute, network/disk activity can be checked to delay fading, and you can control if faders are allowed to change the monitor depth.
  77.  
  78. You can also control if the screen saver should be stopped if the mouse moves. If you have pets that like to bump into your mouse, you may want to turn this setting off - faders will then ignore the mouse, and only stop when a key is pressed.
  79.  
  80. If you have a 3Dfx Voodoo 1 card, you can also allow Setting Sun to use that card to accelerate certain faders. Please see the “3Dfx Support” document for more details.
  81.  
  82.  
  83. The Switching section allows you to select corners of the screen which, when the mouse is moved into them, will either invoke the screen saver or prevent the screen saver from ever activating.
  84.  
  85. By default, these corners are a 5x5 pixel square. Selecting “Use small corner sizes” will reduce this to a 2x2 square in each corner.
  86.  
  87. You can also select a hot key combination which, when pressed, will instantly invoke the screen saver.
  88.  
  89. Both the hotspot corner and the hot key combination can be used in any application, provided Setting Sun is running in the background. If you are running the GoMac Control Panel you may want to avoid selecting the corners at the bottom of the screen - GoMac takes control over these corners, making them unavailable to Setting Sun. As an alternative you may want to try James Thomson’s excellent <http://www.dragthing.com/>, which is fully compatible with Setting Sun!
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119. The Faders panel allows you to select the current screen saver, and to get an instant preview of what will be displayed when the screen saver is invoked.
  120.  
  121. The right hand side of this panel is taken up by the fader’s preferences, if any (this example shows a single slider, which controls the height of the flames). Each fader has different preferences, so the contents of this area will change depending on the current fader.
  122.  
  123. This side of the panel also contains a Web link - clicking this will start up your web browser and take you to the fader’s home page.
  124.  
  125. The panel also contains three buttons. The “Fade Now” button will invoke the current fader in full-screen mode, the “Defaults” button will reset the fader’s preferences back to their default settings, and the “About” button will display the fader’s about box.
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155. The Security panel is divided into two sections: Password Control, and Password.
  156.  
  157. The Password Control section allows you to control when the password is required: this can be used to provide some privacy for your machine when the screen saver is running, and to prevent others from attempting to turn off (or even quit) the screen saver application when the screen saver is not running.
  158.  
  159. It also allows you to set if the password dialog should pause the active fader, or if it should be allowed to continue animating in the background. If you have a slower machine you may want to turn this off to make the password dialog feel more responsive.
  160.  
  161.  
  162. The Password section contains your password, and a hint that can be used to remind you of what your password was. The hint field can be cleared if you don’t need a hint.
  163.  
  164. N.B. - the password security in Setting Sun is adequate for casual users, but it will not thwart a dedicated hacker. Although more complex security schemes are possible, they tend to introduce a risk of system instability. To avoid this, Setting Sun has deliberately opted for a simpler, more stable, mechanism.
  165.  
  166. Failed login attempts will be displayed in a scrolling ticker message across the top of the screen.
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. The System panel is divided into two sections: Display and CPU.
  196.  
  197. The Display section allows you some additional control over the display settings. The “Allow Millions” checkbox indicates if Setting Sun should should change the display depth to Thousands of Colours if it is currently in Millions of Colours. This can be useful for 3D cards with enough VRAM to accelerate full screen rendering in Millions of Colours - selecting this checkbox will prevent a depth change, and may produce a higher quality image.
  198.  
  199. You can also control if the screen should be smoothly faded in and out when a Fader is launched.
  200.  
  201. You may also want to display a Frames-Per-Second counter, to indicate the performance of each fader (up to the maximum of 60fps). Selecting this checkbox will cause the current FPS rate (averaged over the past few seconds) to be displayed at the top left of the display (the FPS count is not displayed in the Fader preview window).
  202.  
  203. If you have multiple displays connected to your Mac, the “Select Display” button can be used to select the display that faders will run on.
  204.  
  205.  
  206. The CPU section allows some additional control over Setting Sun’s CPU usage. The slider indicates the amount of CPU time that Setting Sun should consume - when the slider is at the maximum, absolutely no time will be yielded to other applications.
  207.  
  208. This may cause problems for some background applications (e.g., File Sharing), and the default setting (one increment below the maximum position) will normally provide the best performance.
  209.  
  210. If you wish to allow background applications a greater share of the CPU, reduce the value of the slider. If you have a fast 3D card, you may find that increasing the time yielded to other applications does not decrease the frame rate - in that case, you may want to adjust the slider to allow background applications more time.
  211.  
  212.  
  213. Notes
  214.  
  215. • Running other CPU intensive applications at the same time as Setting Sun can cause jerky animation. If you are running the RC5 client, or Microsoft’s Internet Explorer, you may find that Setting Sun is unable to maintain a consistent frame rate. To obtain the maximum frame rate, adjust the CPU Usage slider on the System panel of the Preferences window.
  216.  
  217. • If you use Setting Sun's password protection feature and would like to protect your Mac on startup, place a copy of the “Fade Now” AppleScript (found in the Fader Support folder) into the Startup Items folder of your System Folder. This AppleScript tells Setting Sun to fade immediately - protecting your Mac as soon as it starts up.
  218.  
  219. • Setting Sun is compatible with Mac OS 9, although it does not take advantage of any Mac OS 9 specific features (e.g., the Keychain, or Multiple Users). Support for these features is planned for a future version.
  220.  
  221.  
  222. Version History
  223.  
  224. 1.4, 7th August 2000
  225. • Added six new faders - Atlantis, Image Cube, Flag, Plasma, RotoZoom, Slide Show. 
  226. • Added photos folder (thanks to Grace Grant, Jonathan Hogg, and Saskia Köhler).
  227. • Added multiple monitor support - can now select which display the animation runs on.
  228. • Fixed bug where Defaults button had no effect for Random fader.
  229. • Fixed bug where “wake up if mouse moves” checkbox was being ignored.
  230. • Faders can now select folders for their content.
  231. • Reduced animation speed of some faders on user request (Explode, FlowerBox, Roller Coaster).
  232. • The Registration window now includes a link to the Register dialog.
  233. • The cursor is now hidden before starting a fade.
  234. • The Roller Coaster fader no longer has a corrupt texture image.
  235. • The Matrix fader now uses smaller characters.
  236. • The Image Cube fader can now display a folder of images, or the current screen content.
  237. • The Chrome fader now defaults to full screen mode.
  238.  
  239. 1.3.2, 4th June 2000
  240. • Added preference to control if network and disk activity is checked before fading.
  241. • Now no longer use Draw Sprocket to fade displays, to work around bug in Draw Sprocket 1.7.3.
  242. • Random fader no longer does unnecessary switch if idle delay is longer than random switch delay.
  243. • Fixed bug where mouse movements would not count as activity if “Wake up if mouse moves” was off.
  244.  
  245. 1.3.1, 2nd June 2000
  246. • Fixed bug where application would crash when fading if the Control Strip was not installed.
  247.  
  248. 1.3, 29th May 2000
  249. • Added preference to control size of hotspot corners.
  250. • Added preference to control if faders are allowed to run behind the password dialog. 
  251. • Added new fader - Star Spiral.
  252. • Added “change every minute” to Random fader.
  253. • Now allow password to contain non-alphanumeric characters.
  254. • Now check for network and disk activity before considering the machine to be idle.
  255. • Now ignore the Energy Saver API on Mac OS 9.0, since it was withdrawn in that release.
  256. • Now manually restore the visibility of the Control Strip, to work around Mac OS 8.5 bug.
  257. • Now use Quesa logo model rather than QuickDraw 3D™.
  258. • Hotspot corners now relative to entire desktop, not just the main monitor.
  259. • Fixed bug in Yum fader which could cause a crash.
  260. • Fixed bug in Clouds fader which could cause a crash if QuickTime Effects was missing.
  261. • Fixed bug in Ripple fader where preferences could fail to be saved.
  262. • Fixed bug where images could sometimes fail to load.
  263. • Fixed bug where a “missing symbol” error would occur on pre-Mac OS 8.5 systems.
  264. • Fixed bug where Energy Saver API was causing instability on Mac OS 9.0.4.
  265. • Fixed bug where the AfterDark Gestalt would be incorrect when the password dialog is visible.
  266. • Fixed bug where the application resources could sometimes be overridden by fader resources.
  267. • Fixed bug where the “Fade Now” button could sometimes be ignored.
  268. • Fixed bug where the registration information could be lost, and the reminder window would re-appear.
  269. • Fixed bug where waking a fade with a keypress could sometimes immediately re-fade.
  270. • The 3Dfx checkbox has been renamed, since it only supports Voodoo 1 cards.
  271. • The Typewriter fader now keeps strings in a resource, rather than hard-coding them.
  272. • The sound effect checkbox has been removed, since it was not implemented.
  273. • Updated documentation to rephrase CPU usage slider after user feedback.
  274. • Mac OS 8.1 now the minimum system supported, in preparation for Carbon.
  275.  
  276. 1.2, 6th October 1999
  277. • Added Random Fader to switch faders automatically.
  278. • Added five new faders - Collage, Dim, HAL 9000, Matrix, and Typewriter.
  279. • Added gamma fades at the start and/or end of a fade.
  280. • Added control over CPU usage, depth switching, and FPS display.
  281. • Added AppleScript support - sample script in “Fader Support” folder will fade Setting Sun on launch.
  282. • Now never fade if the menu bar is hidden or a modal dialog is active.
  283. • Now allow automated apps (e.g., Retrospect) to launch and interrupt a Fader.
  284. • Now allow the Desktop to redraw if a Fader requests a depth change, to allow Ripple to grab a better image.
  285. • Now open Fader resource forks as read-only if running from a read-only volume (e.g., a CD-ROM).
  286. • Now reset to the Blank Screen fader if the Option key is held down while opening the Prefs window.
  287. • Now use Cmd-D as the keyboard shortcut for “Fade Now” rather than Cmd-F.
  288. • Now compatible with Mac OS 9.
  289. • Fixed bug where the Default button sometimes failed to function for OpenGL faders.
  290. • Fixed bug where the “allow depth change” and “allow sounds” preferences were reversed.
  291. • Fixed bug where the menu bar clock would not redraw correctly when password protection was enabled.
  292. • Fixed bug where a sleep time of 0 when password protection was enabled would cause an infinite loop.
  293. • The Ripple fader now allows control over the size of texture used.
  294. • The Yum fader now includes a free Sith Lord.
  295. • The Swarm fader no longer changes the display depth.
  296.  
  297. 1.1, 27th June 1999
  298. • Added 3Dfx support.
  299. • Added workaround for memory leak in 3D drivers, which fixes some crashes and a white screen in Ripple.
  300. • Added control over individual hotspot corners, and improved hotspot activation behaviour.
  301. • Now compatible with Snapz Pro.
  302. • Now weak linked against Internet Config, and will launch without it.
  303. • Now restores previously active app if activity is detected while a fade is starting.
  304. • Improved security by disabling Cmd-Option-Escape when a password is set.
  305. • Improved consistency of fader frame rates on fast machines.
  306. • Fixed bug where some monitors wouldn’t be blanked if the startup monitor was different from menu bar monitor.
  307. • Fixed bug where would wake up after 1 hour if the Energy Saver control panel was set to “never”.
  308. • Fixed bug where the “Wake up if mouse moved” checkbox could sometimes be ignored.
  309. • Fixed bug in the Splines fader where the trail could collapse into a single loop.
  310. • The Clouds fader has a new rotation preference.
  311. • The Pulsar fader is now allowed to run in software.
  312. • The Ripple fader is now allowed to run in software, and has preferences for wave height and colours.
  313.  
  314. 1.0, 14th June 1999
  315. • First release.